home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / gsxxnum.arc / GS-XXNUM.DOC < prev   
Encoding:
Text File  |  1984-06-20  |  8.1 KB  |  260 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.               ******************************************************        
  14.               *                                                    *        
  15.               *       GS-UNNUM.EXE     and     GS-RENUM.EXE        *        
  16.               *       version 1.02             version 1.01        *        
  17.               *                                                    *        
  18.               *                                                    *        
  19.               *       (C)Copyright GILMORE SYSTEMS, 1984           *        
  20.               *       (C)Copyright Charles B. Gilmore, 1984        *        
  21.               *                                                    *        
  22.               *                                                    *        
  23.               *  You are hereby granted a license to use, share,   *        
  24.               *  copy, and distribute these two programs and this  *        
  25.               *  documentation, provided that this notice, and     *        
  26.               *  the Copyright information is not removed or       *        
  27.               *  altered in any way.                               *        
  28.               *                                                    *        
  29.               *  These two programs are provided on an AS-IS basis *        
  30.               *  without warranty of any kind expressed or implied.*        
  31.               *  The entire risk as to quality and performance of  *        
  32.               *  these programs rests solely with the user. In no  *        
  33.               *  event will Gilmore Systems be liable to you for   *        
  34.               *  any damages, consequential or inconsequential. By *        
  35.               *  operating any of the above programs, you acknow-  *        
  36.               *  ledge you have read and understand this agreement *        
  37.               *  and agree to be bound by its terms and conditions.*        
  38.               *                                                    *        
  39.               *  If you are using these programs and find them of  *        
  40.               *  value, or if you have any suggestions or comments *        
  41.               *  please send your name and address along with      *        
  42.               *  your comments to:                                 *        
  43.               *                                                    *        
  44.               *                   GILMORE SYSTEMS                  *        
  45.               *                      PO BOX 511                    *        
  46.               *               NUTTING LAKE, MA. 01865              *        
  47.               *                                                    *        
  48.               *  A $5 donation to support future public domain     *        
  49.               *  devlopments would be appreciated, but is by       *        
  50.               *  no means required.                                *        
  51.               *                                                    *        
  52.               ******************************************************        
  53.  
  54.  
  55.  
  56.     GS-UNNUM.DOC                                                     Page  1
  57.  
  58.  
  59.                                     GS-UNNUM
  60.  
  61.  
  62.     The  GS-UNNUM  program  will  un-number  all  unreferenced lines in your
  63.     BASIC  programs  so  that  the  '/N'  option  can be used with the BASIC
  64.     compiler.  To  use  this  program, you must save your BASIC program with
  65.     the  ',A'  option.  The  advantages  of  using this program and the '/N'
  66.     option on the compiler are as follows:                                  
  67.  
  68.  
  69.        1  Depending  on which compiler options you choose, extra bytes of
  70.           code  are  generated  by the Compiler for each numbered line in
  71.           your program, resulting in larger .EXE files. This program will
  72.           eliminate generation of these extra bytes of code, resulting in
  73.           smaller .EXE files and faster load time.                       
  74.  
  75.        2  Compile  time  is  sped up considerably when the '/N' option is
  76.           used.                                                          
  77.  
  78.        3  Less  disk  space is required to store the un-numbered program.
  79.           The  un-numbered  program can be re-numbered any time using the
  80.           GS-RENUM  program.  This  eliminates the need to keep a copy of
  81.           your original numbered program on disk.                        
  82.  
  83.        4  This  program  runs  extremely  fast, so it costs you almost no
  84.           time to un-number your program.                                
  85.  
  86.  
  87.     Compared  with  similar  programs,  GS-UNNUM  runs  up  to  of  6  times
  88.     faster,  and  misses  no  references. Many similar programs miss the ERL
  89.     references.  All  branch  instructions  must  be  properly  delimited as
  90.     outlined  in  the  BASIC  manual. Once you start the program, everything
  91.     will  be  self  explanatory.  Incidentally,  Your BASIC program does not
  92.     have  to  be  numbered by tens, GS-UNNUM will handle any line numbering.
  93.  
  94.  
  95.                            Differences in Version 1.01
  96.  
  97.  
  98.          1  Version  1.00  did not recognize RESTORE followed by a line
  99.             number - this has now been fixed.                          
  100.  
  101.          2  The  initial  startup screen does not have a built in delay
  102.             anymore - hitting any key starts the program.              
  103.  
  104.          3  Many people have requested that the program indent unlabled
  105.             lines.  The  reason  for not indenting the lines was to cut
  106.             down  on disk storage space. In any event, Version 1.01 now
  107.             prompts you as to whether or not you want this indentation.
  108.  
  109.          4  Version  1.01  has  been  made  to execute even faster than
  110.             version 1.00. The greatest speed difference can be realized
  111.             when   you   have   multiple   statements   across   lines.
  112.  
  113.  
  114.  
  115.                                           (C)Copyright GILMORE SYSTEMS, 1984
  116.  
  117.  
  118.  
  119.     GS-UNNUM.DOC                                                     Page  2
  120.  
  121.  
  122.                            Differences in Version 1.02
  123.  
  124.  
  125.          1  Version  1.02  now provides an option to scan for lowercase
  126.             BASIC  references.  Selecting  this  option  will  slow the
  127.             program  down  a  bit,  so  try  to  avoid  it  if speed is
  128.             important.                                                 
  129.  
  130.          2  Internal  modifications  allow your input file to come from
  131.             most text editors now.                                     
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.                                           (C)Copyright GILMORE SYSTEMS, 1984
  179.  
  180.  
  181.  
  182.     GS-RENUM.DOC                                                     Page  3
  183.  
  184.  
  185.                                     GS-RENUM
  186.  
  187.  
  188.     GS-RENUM  undoes  what  GS-UNNUM  does.  As long as you have not altered
  189.     the un-numbered output from the GS-UNNUM program, GS-RENUM will renumber
  190.     your  un-numbered  program  so that it may be loaded and/or run with the
  191.     BASIC  interpreter.  Once  you have loaded the output of GS-RENUM in the
  192.     BASIC  interpreter,  you  would  be advised to issue the 'renum' command
  193.     in BASIC.                                                               
  194.  
  195.     When  GS-RENUM  is  started,  the prompts will be self-explanatory. This
  196.     program  runs  extremely  fast,  so  once  again, it costs you almost no
  197.     time at all to use this program.                                        
  198.  
  199.  
  200.                            Differences in Version 1.01
  201.  
  202.  
  203.          1  The  initial  startup screen does not have a built in delay
  204.             anymore  -  hitting any key starts the program. This is the
  205.             only difference from Version 1.00.                         
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.                                      (C)Copyright GILMORE SYSTEMS, 1984
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.